@thi.ng/checks

What is @thi.ng/checks?

@thi.ng/checks is a utility library for various type checks and predicates in JavaScript. It provides a wide range of functions to check types, values, and conditions, making it easier to validate data and ensure code correctness.

What are @thi.ng/checks's main functionalities?

Type Checks

This feature allows you to check the type of a given value. The `isString` function checks if the value is a string, and the `isNumber` function checks if the value is a number.

const { isString, isNumber } = require('@thi.ng/checks');

console.log(isString('hello')); // true
console.log(isNumber(123)); // true
console.log(isNumber('123')); // false

Array Checks

This feature provides functions to check if a value is an array and if an array is empty. The `isArray` function checks if the value is an array, and the `isEmptyArray` function checks if the array is empty.

const { isArray, isEmptyArray } = require('@thi.ng/checks');

console.log(isArray([1, 2, 3])); // true
console.log(isEmptyArray([])); // true
console.log(isEmptyArray([1])); // false

Object Checks

This feature includes functions to check if a value is an object and if an object is empty. The `isObject` function checks if the value is an object, and the `isEmptyObject` function checks if the object is empty.

const { isObject, isEmptyObject } = require('@thi.ng/checks');

console.log(isObject({ a: 1 })); // true
console.log(isEmptyObject({})); // true
console.log(isEmptyObject({ a: 1 })); // false

Function Checks

This feature provides a function to check if a value is a function. The `isFunction` function checks if the value is a function.

const { isFunction } = require('@thi.ng/checks');

console.log(isFunction(function() {})); // true
console.log(isFunction(() => {})); // true
console.log(isFunction(123)); // false

String Checks

This feature includes functions to check if a value is a string and if a string is empty. The `isString` function checks if the value is a string, and the `isEmptyString` function checks if the string is empty.

const { isString, isEmptyString } = require('@thi.ng/checks');

console.log(isString('hello')); // true
console.log(isEmptyString('')); // true
console.log(isEmptyString('hello')); // false

Other packages similar to @thi.ng/checks

lodash

Lodash is a modern JavaScript utility library delivering modularity, performance, and extras. It provides a wide range of utility functions for common programming tasks, including type checks, which are similar to those provided by @thi.ng/checks.

ramda

Ramda is a practical functional library for JavaScript programmers. It provides utility functions for functional programming, including type checks and predicates, similar to @thi.ng/checks.

validator

Validator is a library for string validation and sanitization. While it focuses more on string validation, it also provides some type-checking functions similar to those in @thi.ng/checks.

check-types

Check-types is a library for checking types and conditions in JavaScript. It provides a similar range of type-checking functions as @thi.ng/checks, making it a good alternative.

README

[!NOTE] This is one of 199 standalone projects, maintained as part of the @thi.ng/umbrella monorepo and anti-framework.

🚀 Please help me to work full-time on these projects by sponsoring me on GitHub. Thank you! ❤️

• About
• Status
• Installation
• Dependencies
• API
• Authors
• License

About

Collection of 70+ type, feature & value checks.

• exists
• existsAndNotNull
• hasBigInt
• hasCrypto
• hasMaxLength
• hasMinLength
• hasPerformance
• hasWASM
• hasWebGL
• hasWebSocket
• implementsFunction
• isASCII
• isAlpha
• isAlphaNum
• isArray
• isArrayBufferLike
• isArrayBufferView
• isArrayLike
• isAsyncIterable
• isBigInt
• isBlob
• isBoolean
• isChrome
• isDataURL
• isDate
• isEven
• isFalse
• isFile
• isFirefox
• isFloatString
• isFunction
• isGenerator
• isHex
• isHexColor
• isIE
• isIllegalKey
• isInRange
• isInt32
• isIntString
• isIterable
• isMap
• isMobile
• isNaN
• isNegative
• isNil
• isNode
• isNotStringAndIterable
• isNull
• isNumber
• isNumeric
• isNumericFloat
• isNumericInt
• isObject
• isOdd
• isPlainObject
• isPositive
• isPrimitive
• isPrintableASCII
• isPromise
• isPromiseLike
• isProtoPath
• isRegExp
• isSafari
• isSet
• isString
• isSymbol
• isTouchEvent
• isTransferable
• isTrue
• isTypedArray
• isUUID
• isUUIDv4
• isUint32
• isUndefined
• isZero

Status

STABLE - used in production

Search or submit any issues for this package

Installation

yarn add @thi.ng/checks

ESM import:

import * as ch from "@thi.ng/checks";

Browser ESM import:

<script type="module" src="https://esm.run/@thi.ng/checks"></script>

JSDelivr documentation

For Node.js REPL:

const ch = await import("@thi.ng/checks");

Package sizes (brotli'd, pre-treeshake): ESM: 1.65 KB

Dependencies

• tslib

API

Generated API docs

TODO

Authors

• Karsten Schmidt (Main author)
• Gavin Cannizzaro
• Jay Zawrotny

If this project contributes to an academic publication, please cite it as:

@misc{thing-checks,
  title = "@thi.ng/checks",
  author = "Karsten Schmidt and others",
  note = "https://thi.ng/checks",
  year = 2016
}

License

© 2016 - 2024 Karsten Schmidt // Apache License 2.0